#### CALCulate<Ch>:PARameter...

This subsystem assigns names and measurement parameters to traces. The commands are device-specific.

Command tree: CALCulate<Ch>:PARameter

:CATalog?

:DEFine

:DELete

:MEASure

:SDEFine

:SELect

##### CALCulate<Ch>:PARameter:CATalog?

Returns the trace names and measurement parameters of all traces assigned to a particular channel.

<Ch> | Channel number. If unspecified the numeric suffix is set to 1.
Response | String parameter with comma-separated list of trace names and measurement parameters, e.g. 'CH4TR1,S11,CH4TR2,S12'. The measurement parameters are returned according to the naming convention of CALCulate<Ch>:PARameter:SDEFine . The order of traces in the list reflects their creation time: The oldest trace is the first, the newest trace is the last trace in the list.
*RST value | –
SCPI, Command Types | Device-specific, query only.
Example: | CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'.

##### CALCulate<Ch>:PARameter:DEFine
'<string>', S11 | ... | S44 | A | B | C | D | R1 | R2 | R3 | R4 | AB | AC | AD | BA | BC | BD | CA | CB | CD | DA | DB | DC | AR1 | ... | DR4 | R1A | ... | R4D | R1R2 | ... | R4R3, [<numeric_value>]

Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace is not displayed. To display a trace defined via CALCulate<Ch>:PARameter:DEFine, a window must be created (DISPlay:WINDow<Wnd>[:STATe] ON
) and the trace must be assigned to this window (DISPlay:WINDow<Wnd>:TRACe:FEED
); see example below.

Traces must be selected to become active traces; see CALCulate:PARameter:SELect
.

This command has been implemented for compatibility reasons. The parameter names in this command differ from ZVA conventions; moreover the parameter list is not complete. The alternative command CALCulate<Ch>:PARameter:SDEFine
uses a complete parameter list with compatible names.

<Ch> | Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
'<string>' | Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
S11, ... R4R3 | Measurement parameter; see list of parameters below.
*RST value | –
[<numeric_value>] | Test port number, ignored in the current firmware version.
Range [def. unit] | 1 to 4 [–] (depending on instrument model)
*RST value | –
SCPI, Command Types | Device-specific, no query. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
Example: | CALC4:PAR:DEF 'Ch4Tr1', S11 Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND:STAT ON Create diagram area no. 1. DISP:WIND:TRAC:FEED 'CH4TR1' Display the generated trace in diagram area no. 1.

The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):

S11 | S12 | S13 | S14 | S21 | S22 | S23 | S24 | S31 | S32 | S33 | S34 | S41 | S42 | S43 | S44 | S-parameters
A | B | C | D | Wave quantities b1, b2, b3, b4 (received waves)
R1 | R2 | R3 | R4 | Wave quantities a1, a2, a3, a4 (reference waves)
AB | AC | AD | BA | BC | BD | CA | CB | CD | DA | dB | DC | Ratio of wave quantities b1/b2, b1/b3, ... , b4/b3 (received waves only)
AR1 | AR2 | AR3 | AR4 | BR1 | BR2 | BR3 | BR4 | CR1 | CR2 | CR3 | CR4 | DR1 | DR2 | DR3 | DR4 | R1A | R1B | R1C | R1D | R2A | R2B | R2C | R2D | R3A | R3B | R3C | R3D | R4A | R4B | R4C | R4D | Ratio of wave quantities b1/a1, b1/a2, ... , b4/a4, a1/b1, a1/b2, ..., A4/B4 (received waves to reference waves or reference waves to received waves)
R1R2 | R1R3 | R1R4 | R2R1 | R2R3 | R2R4 | R3R1 | R3R2 | R3R4 | R4R1 | R4R2 | R4R3 | Ratio of wave quantities a1/a2, a1/a3, ... , a4/a3 (reference waves only)

##### CALCulate<Ch>:PARameter:DELete '<string>'

Deletes a trace with a specified trace name and channel.

<Ch> | Channel number.
'<string>' | Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
*RST value | –
SCPI, Command Types | Device-specific, no query.
Example: | CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'. CALC4:PAR:DEL 'CH4TR1' Delete the created trace.

##### CALCulate<Ch>:PARameter:MEASure
'<string>', 'S11' | ... | 'S0101' | ... | 'SCD11' | ... | 'Y11' | ... | 'Z11' | ... | 'Y-S11' | ... | 'Z-S11' | ... | 'a1' | ... | 'A01' | ... | 'B1' | ... | 'B01' | ... | 'B2/A1' | ... 'B02/A01' | ...

Assigns a measurement parameter to an existing trace.

Note: To create a new trace and at the same time assign the attributes, use CALCulate<Ch>:PARameter:S D EFine
. To display the trace, create a window
(DISPlay:WINDow<Wnd>[:STATe]
ON) and assign the trace to this window
(DISPlay:WINDow<Wnd>:TRACe:FEED
); see example below.

Traces must be selected to become active traces; see CALCulate:PARameter:SELect
. CALCulate<Ch>:PARameter:CATalog?
returns a list of all defined traces. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.

<Ch> | Channel number of an existing channel containing the referenced trace.
'<string>' | Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
'S11', ... | Measurement parameter (string variable); see list of in the CALCulate<Ch>:PARameter:SDEFine command description. A query of a wave quantity 'xy' returns 'xyD<n><Detector>', where <n> numbers the source (drive) port, and <Detector> denotes the detector setting (SAM for a normal (sample), RMS or PEAK for an RMS or peak detector). A query of a ratio 'x/y' returns 'xD<n>/yD<m><Detector>', where <n> and <m> number the source ports.
*RST value | –
SCPI, Command Types | Device-specific, with query (see 'S11',... parameter description above).
Example: | CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:MEAS 'Ch4Tr1', 'a1' Change the measurement parameter of the trace and measure the wave quantity a1. CALC4:PAR:MEAS? 'Ch4Tr1' Query the measured quantity. The response is 'A1D1SAM'.

##### CALCulate<Ch>:PARameter:SDEFine
'<string>', 'S11' | ... | 'S0101' | ... | 'SCD11' | ... | 'Y11' | ... | 'Z11' | ... | 'Y-S11' | ... | 'Z-S11' | ... | 'a1' | ... | 'A01' | ... | 'B1' | ... | 'B01' | ... | 'B2/A1' | ... 'B02/A01' | ... | 'Pmtr2D1' | ...

Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace becomes the active trace in the channel but is not displayed.

To display the trace defined via CALCulate<Ch>:PARameter:SDEFine, create a window (DISPlay:WINDow<Wnd>[:STATe] ON
) and assign the trace to this window (DISPlay:WINDow<Wnd>:TRACe:FEED
); see example below. CALCulate<Ch>:PARameter:MEASure
changes the measurement parameter of an existing trace.

To select an existing trace as the active trace, use CALCulate:PARameter:SELect
. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.

In FW versions <V1.90, traces created with CALCulate<Ch>:PARameter:SDEFine must be selected explicitly (CALCulate:PARameter:SELect) in order to become active traces.

<Ch> | Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
'<string>' | Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
'S11', ... | Measurement parameter (string variable); see list of parameters below.
*RST value | –
SCPI, Command Types | Device-specific, no query. CALCulate<Ch>:PARameter:MEASure? '<Trc_name>' queries the measurement parameter of the trace. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
Example: | CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND2:STAT ON Create diagram area no. 2. DISP:WIND2:TRAC:FEED 'CH4TR1' Display the generated trace in diagram area no. 2.

The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):

'S11' | 'S12' | ... | 'S0101' | ... | Normal mode S-parameters S<out><in>, where <out> and <in> denote the output and input port numbers of the DUT. To avoid ambiguities, <out> and <in> must be either both 1-digit numbers (e.g. 21) or both 2-digit numbers (e.g. 2121 or 0133).
'SCD11' | | Mixed mode S-parameters S<mout><m in>, where <mout> and <min> denote the output and input port modes. All combinations of S (single-ended, unbalanced), D (differential) and C (common) are allowed. Port numbers like for normal mode S-parameters.
'Y11' | ... | 'YSS11' | ... | 'YCC11' | ... | 'YDD11' | 'Z11' | ... | 'ZSS11' | ... | 'ZCC11' | ... | 'ZDD11' | ... | Short-circuit Y-parameters and open-circuit Z-parameters with port modes and port numbers like for normal mode S-parameters*).
'Y-S11' | ... | 'Y-SSS11' | ... | 'Y-SCC11' | ... | 'Y-SDD11' | 'Z-S11' | ... | 'Z-SSS11' | ... | 'Z-SCC11' | ... | 'Z-SDD11' | ... | S-parameters converted to matched-circuit admittances and impedances with port modes and port numbers like for normal mode S-parameters.
'a1' | ... | 'a01' | ... | 'B1' | ... | 'B01' | ... | 'a1SAM' | 'a1RMS' | 'a1PEAK' | | Wave quantities with port numbers like for normal mode S-parameters. The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector. The observation time for RMS and peak detectors is set via [SENSe<Ch>:]SWEep:D ETector:TIME .
'a1D2' | ... | 'a01D2' | ... | 'B1D2' | ... | 'B01D2' | ... | 'a1D1SAM' | 'a1D1RMS' | 'a1D1PEAK' | ... | Wave quantities with port numbers and source port numbers (D<no> for drive port). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector.
'a1G2' | ... | 'a01G2' | ... | 'B1G2' | ... | 'B01G2' | ... | 'a1G1SAM' | 'a1G1RMS' | 'a1G1PEAK' | ... | Wave quantities with port numbers and external generator providing the stimulus signal (G<no> for generator no.). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector.
'b2/a1' | ... 'b02/a01' | ... | 'b2/a1SAM' | 'b2/a1RMS' | 'b2/a1PEAK' | ... | Ratio of wave quantities with port numbers like for normal mode S-parameters. The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector.
'b2D1/a1D1' | ... 'b02D1/a01D1' | ... 'b2D1/a1D1SAM' | 'b2D1/a1D1RMS' | 'b2D1/a1D1PEAK' | ... | Ratio of wave quantities with port numbers and source port numbers (D<no> for drive port). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector.
'b2G1/a1G1' | ... 'b02G1/a01G1' | ... 'b2G1/a1G1SAM' | 'b2G1/a1G1RMS' | 'b2G1/a1G1PEAK' | ... | Ratio of wave quantities with port numbers and external generator providing the stimulus signal (G<no> for generator no.). The strings SAM, RMS, PEAK appended to the wave quantities denote a normal (sample), RMS or peak detector.
'IMB21' | 'IMB12' | 'IMB31' | ... | Imbalance parameter for balanced ports Imb<receive_port><drive_port>. The indices denote the logical receive port and the logical drive port of the analyzer.
'KFAC21' | 'KFAC12' | ... | Stability factor K (for unbalanced ports only)
'MUF121' | 'MUF112' | ... | Stability factor m 1 (for unbalanced ports only)
'MUF221' | 'MUF212' | ... | Stability factor m 2 (for unbalanced ports only)
'PAE21' | PAE12' | | Power added efficiency
'DC1V' | 'DC10V' (query returns 'DC1V' or 'DC10V') | DC MEAS 1 V, DC MEAS 10 V
'Pmtr1G1' | 'Pmtr2G1' | 'Pmtr3D1' | Power sensor measurement using a power meter 'Pmtr<n>' and either an external generator 'G<n>' or an analyzer source port 'D<n>'

*)Selecting a parameter Y...<n><m> or Z...<n><m> sets the range of port numbers to be considered for the Y and Z-parameter measurement to <n>:<m>.

##### CALCulate<Ch>:PARameter:SELect <string>

Selects an existing trace as the active trace of the channel. All trace commands without explicit reference to the trace name act on the active trace (e.g. CALCulate<Ch>:FORMat
). CALCulate<Ch>:PARameter:SELect is necessary e.g. if the active trace of a channel has been deleted.

<Ch> | Channel number.
<string> | Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
*RST value | –
SCPI, Command Types | Device-specific, with query (returns the name of the active trace).
Example: | CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. The trace is the active trace in channel 4. CALC4:PAR:SDEF 'Ch4Tr2', 'S22' Create another trace named Ch4Tr2 to measure the output reflection coefficient S22. Again this new trace becomes the active trace in channel 4. CALC4:PAR:SEL 'Ch4Tr1' Select the first trace Ch4Tr1 as the active trace. CALC4:FORM MLIN Calculate the magnitude of S11 and display it in a linearly scaled Cartesian diagram.